package climspace.ejb;

import java.io.Serializable;
import java.util.Date;

public interface WeatherStationBean extends Serializable {
	
	/**
	 * method to retrieve current weather data by station id
	 * @param stationId the station id to query
	 * @param desiredOutputFormat: "jsonOutputFormat" or "kmlOutputFormat"
	 * @return current weather data in JSON or KML format
	 */
	String getCurrentWeatherData(String stationId, String desiredOutputFormat);

	/**
	 * method to submit an archive query by station and date
	 * @param stationId Use "*" for all stations
	 * @param fromDate beginning data date
	 * @param toDate ending data date
	 * @param userName CAPA Analyst username
	 * @return the job id ticket number
	 */
	String getHistoricalWeatherData(String stationId, Date fromDate, Date toDate, String userName);
	
	/**
	 * method to download the historical query output file
	 * @param jobID the job id ticket number
	 * @param outFolder the folder to store the output file
	 * @return 
	 */
	String downloadDataFileByJobID(String jobID, String outFolder);
}
